home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 January / Macworld (1998-01).dmg / Shareware World / Comms & Internet / CogniSieve Player / Manual < prev    next >
Text File  |  1997-10-01  |  8KB  |  136 lines

  1. CogniSieve
  2.  
  3. ©1997 Xanatech, Inc. All rights Reserved.
  4. http://home1.pacific.net.sg/~mchen/xanatech/
  5.  
  6. email: 
  7. mchen@pacific.net.sg
  8.  
  9.  
  10. Contents
  11.  
  12. - Introduction
  13. - How to use CogniSieve
  14. - Phone/Email/URL Sieve
  15. - Shareware Fee and Registration
  16. - Customized Sieve Service
  17. - Contacting Us
  18.  
  19.  
  20. Introduction
  21.  
  22. CogniSieve is the first example of a user programmable Cognitron for Mac OS PowerPC systems. Cognitrons are robotic or software components that perform recognition tasks. This shareware version of CogniSieve contains a sieve to recognize email addresses and telephone numbers. However, because the associational rules for recognition can be edited by the user, CogniSieve can be customized to extract any items of interest such as names, addresses, a particular column of numbers in a table of share prices, or even complex semantic tokens such as all sentences and phrases announcing parties (as in an occasion for fun). Unlike keyword based methods, it would not be confused by sentences that contain the word party used in another sense, such as "involvement" (to be a party to) or political entities.
  23.  
  24. Cognitrons are not something totally new. The Newton's Smart Assist feature which recognises and "understands" simple commands such as "dinner with John" is an early example. The latest example is Apple's recently announced Data Detectors. (See http://www.research.apple.com/research/tech/AppleDataDetectors/Default.html.) A lot more of them will surface with the rise of agent software. They are essential for smarter User/Agent communication.
  25.  
  26. How to Use CogniSieve
  27.  
  28. First make sure you have three files, the CogniSieve Player, CogniSieve Manual, the Read Me and the Phone/Email/URL Sieve folder. Make a back-up copy of Phone/Email/URL Sieve folder, as it may get corrupted during usage.
  29.  
  30. CogniSieve files come in two flavors. There is one Rules  file (regular document icon) where all the associational rules are stored, and there can be one or more associated Sieve  files (magnifier icon) which provide a choice of ways for one to view or use the rules.
  31.  
  32. Open a CogniSieve file by double clicking its icon. The first time you open a CogniSieve Sieve file, after copying it to a new location,  you will get a open File dialog asking you to locate its linked Rule file. When you get this dialog, just navigate to the requested Rule file and double click on it. Then the Sieve file will open.
  33.  
  34. When the user opens the Phone/Emial Sieve provided, he should see a window with two panes separated by a blue line in the middle. The lower pane is the Input pane where one could type or paste text to be parsed. The upper pane with item headers in the top row, is the Output pane where the results of sieving will be displayed.
  35.  
  36. ( Before parsing any text, you may wish to edit or rearrange the order of the items headers in the Output Pane by selecting them and using the usual Cut or Paste commands. If you delete the item headers, make sure you have saved a copy of the Sieve file with headers. The output will be neater if the order of the item headers correspond to the order of the items in the text to be parsed. )
  37.  
  38. I. Paste some text into the Input (lower) pane or type into it. After a two second delay, the program will automatically start to scan the text. You can force it to rescan at any time by choosing menuitem Process Input under the Parser Menu (Command-3). If anything is recognised in the text, it will appear in one of the columns in the upper (Output) pane.
  39.  
  40. II. Copy the results of sieving in the Output pane and paste into other programs such as Excel. Since the sieved items are separated by tabs and returns, when you paste them into a spreadsheet each item will be placed into individual cells.
  41.  
  42. When you quit, the program may ask if you want to save changes. Saving will remember any changes you made to the window size, position as well as all the text that you have processed. (There is a bug that may occur when a lot of text is saved. The progress bar window may not close after all the saving is done. Just click on the Stop button to dismiss it.)
  43.  
  44. If you wish to see how the parsing is done, open the middle pane by dragging the blue line apart and choose menuitem Process Input. To see the processing take place stepwise, choose the menuitem Tokenise (Command-1) followed by repeated Do Single Step (Command-2) actions.
  45.  
  46.  
  47. Phone Number Sieve
  48.  
  49. The rules for this sieve will allow it to recognise all telephone numbers with the following variants. We realise this may not cover every country.
  50.  
  51. 7 digit local numbers
  52. #######
  53. ### ####
  54. ###-####
  55.  
  56. 8 digit local numbers
  57. ########
  58. #### ####
  59. ####-####
  60.  
  61. #-local_no
  62. ###-local_no
  63. (###) local_no
  64. #-###-local_no
  65.  
  66. phone_no ( alphanumeric string )
  67. e.g. 123-2123 (fax)
  68.  
  69. Email Sieve
  70.  
  71. The Email sieve is somewhat restrictive. Addresses will be recognised if they are of the form:
  72.  
  73. id string @ address string
  74.  
  75. The id string is an alphanumeric or numeric string. Symbols such as #, - or period may occur in the string, but other symbols will prevent recognition.
  76.  
  77. The address string is of the form of multiple repeats of  (alpha-numeric).(alpha-numeric).(alpha-numeric) etc.
  78.  
  79. Despite these restrictions, we think most of the common email addresses should be recognised.
  80.  
  81. URL Sieve
  82.  
  83. Web addresses are recognised if they are of the form:
  84.  
  85. http:// path name or ftp:// path name
  86.  
  87. The path name is any repeated sequence of alphanumeric strings separated by periods or slashes.
  88.  
  89. Shareware Fee and Registration
  90.  
  91. This Player version of CogniSieve is shareware. If you find it useful and would like to continue to use it after a trial period of one month, you must register your copy of the software by using the included Register application. Payment is handled through a company called Kagi Software.
  92.  
  93. Shareware fee : $10.00
  94.  
  95. CogniSieve has the following pricing.
  96. Single user licenses, $10 per user
  97. A Site License costs $270 (roughly equal to 27 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  98. A World-Wide License costs $1000 and it covers all locations for your organization on the planet earth.
  99.  
  100. Paying for CogniSieve is fairly simple. Open the Register program that accompanies CogniSieve. Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. More specifics on the Register program to follow. Kagi handles my payment processing.
  101.  
  102. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  103.  
  104. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  105.  
  106. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  107.  
  108. Kagi
  109. 1442-A Walnut Street #392-2WX
  110. Berkeley, California 94709-1405
  111. USA
  112.  
  113. Customized Sieve Service
  114.  
  115. This shareware version does not support editing of the rules. If you are interested in a version that allows editing, or in our Customized Sieve Service, please contact us by email for further details. You should make a list of the general characteristics of the patterns that you would like to be able to recognise and have some examples. Including a few examples of items that might seem similar but should not get recognised will also be useful.
  116.  
  117. Contacting Us
  118.  
  119. Visit our web site for the latest news and versions of shareware:
  120. http://home1.pacific.net.sg/~mchen/xanatech/
  121.  
  122. To contact us it's best to use email:
  123. mchen@pacific.net.sg
  124.  
  125. but if you really must use snail mail, then you can write to:
  126.  
  127. Xanatech, Inc.
  128. 20 Fresh Pond Place
  129. Cambridge, MA 032138
  130. USA
  131.  
  132. or
  133. Xanatech
  134. 61 Oriole Crescent, Suite 1
  135. Singapore 288652
  136.